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Introduction 


1.1 Overview 


This guide introduces key concepts of the XENIX system by presenting 
them in a tutorial format. 


It begins with a “demonstration” that explains an actual computer session, 
including command usage and correcting typing errors. Basic concepts 
such as files, commands, and pattern matching are also introduced. 


Finally, these and other concepts are applied to many “real world” exam- 
ples, such as file manipulation, terminal configuration, process control, 
and status information. 


Note 


This guide should be read before the other XENIX documentation; 
however, for more detailed discussions of all topics covered here, 
consult the other user’s and reference guides in the set. 


1.2 The XENIX System 


The XENIX system consists of a general-purpose multi-user operating sys- 
tem and over one hundred utilities and application programs. In addition 
to the XENIX Operating System described in this guide, two other XENIX 
system packages are available: the XENIX Development System and the 
XENIX Text Processing System. 


1.3 The XENIX Working Environment 


The XENIX system is built around the XENIX operating system. The pur- 
pose of an operating system is to efficiently organize and control the 
resources of a computer so that they can be used by real people. These 
resources include memory, disks, lineprinters, terminals, and any other 
peripheral devices connected to the system. The heart of the XENIX sys- 
tem is a “multi-user” and ‘‘multi-tasking” operating system. A multi-user 
system permits several users to use a computer simultaneously, thus pro- 
viding lower cost in computing power per user. A multi-tasking system per- 
mits several programs to run at the same time and increases productivity 
because multiple programs can run simultaneously rather than in 
sequence. 


Because UNIX (and thus XENIX) has been accepted as a standard for 
“high-end” operating systems, a great deal of software is available for this 
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environment. In addition, XENIX is a bridge to the MS-DOS operating sys- 
tem, the most widely used 16-bit operating system in the world. For sys- 
tems that support DOS, XENIX provides commands that let you access 
DOS format files and disks. ‘The XENIX system also includes several widely 
praised enhancements developed at the University of California at 
Berkeley, and a visual interface similar to other Microsoft productivity tool 
interfaces. 


Other characteristics of the XENIX system include: 


A powerful command language for programming XENIX com- 
mands. Unlike other interactive command languages, the XENIX 
‘‘shell’’ is a full programming language. 


Simple and consistent naming conventions. Names can be used 
absolutely, or relative to any directory in the file system. 


Device-independent input and output: each physical device, from 
interactive terminals to main memory, is treated like a file, allowing 
uniform file and device input and output. 


A set of related text editors, including a full screen editor. 


Flexible text processing facilities. In XENIX, commands exist to 
find and extract patterns of text from files, to compare and find 
differences between files, and to search through and compare direc- 
tories. Text formatting, typesetting, and spelling error-detection 
facilities, as well as a facility for formatting and typesetting complex 
tables and equations are also available. 


A sophisticated “‘desk-calculator” program. 


Mountable and dismountable file systems that permit addition of 
floppy disks to the file system. 


A complete set of flexible directory and file protections that allows 
all combinations of read, write, and execute access for the owner of 
each file or directory, as well as for groups of users. 


Facilities for creating, accessing, moving, and processing files and 
directories in a simple and uniform way. 
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1.4 Using This Guide 
This guide is organized as follows: 


Chapter 1: Introduction 
This chapter gives an introduction and overview of the XENIX 
system. 


Chapter 2: Demonstration 
This chapter gives you hands-on experience in using the XENIX 
system. 


Chapter3: Basic Concepts 
This chapter explains the fundamental concepts that you need to 
understand before you begin to use the system. Included here are 
sections on the file system, naming conventions, commands, and 
input and output. 


Chapter4: Tasks 


This chapter explains how to perform everyday tasks using 
appropriate XENIX commands. 
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2.1 Introduction 


This chapter contains a senGnsiaion run designed to help you get used to 
the XENIX system, so that you can quickly start to make effective use of it. 
It shows you how to login, how to enter at your keyboard, what to do about 
mistakes in entering, how to enter commands and how to log out. 


2.2 Before You Log In 


Before you can log in to the system, your name must be added to the 
XENIX user list. At that time you will be given a login name and a pass- 
word. You may have to add your name yourself, or someone else may be 
assigned this task; it all depends on the environment in which your system 
is used. In any case, see the XENIX Operations Guide and for detailed 
information on adding users. 


When you are given an account on the XENIX system you will also receive a 
user name, a password, and a login directory. Once you have these, all you 
need is a terminal from which you can log in to the system. KENIX sup- 
ports most terminals and you should have no problem getting your terminal 
to work with XENIX. Once again, see the XENIX peranaiys Guide for 
more information on how to configure your terminal. 


2.3 Logging In 


Normally the system is sitting idle with a “login: prompt on the terminal 
screen. If the system displays nonsense characters when you enter text, 
then your terminal is probably receiving information at the wrong speed 
and you should check your terminal switches. If the switches are set 
correctly, push the BREAK or INTERRUPT key a few times. 

When you get a “login:” message, enter your login name, then press 
RETURN; the system will not do anything until you do. If a password is 
required, you will be asked for it. The password that you enter does not 
appear on the screen. This prevents others from viewing it. Do not forget 
to press RETURN after you enter your password. Next you see the line 


TERM = (unknown) 
Enter your terminal type (for example, ansi) and press RETURN. 
A successful log in produces a “‘prompt character”, a single character that 


indicates the system is ready to accept commands. The prompt is usually a 
dollar sign ($) ora percent sign (%). 
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You may also get a login message such as: 
you have mail 


telling you that another system user has sent you mail, 


2.4 Typing Commands 


Once the prompt character appears, the system is ready to respond to com- 
mands entered at the terminal. Try entering: 


date 
followed by RETURN. The system responds by displaying something like: 

Mon Jun 16 14:17:10 EST 1985 
Do not forget to press the RETURN key after the command, or nothing will 
happen. The RETURN key will not be mentioned again, but do not forget 
_it has to be entered at the end of each command line. On some terminals 
RETURN may be labeled "ENTER" or"CR", but in all cases, the key per- 
forms the same function. 
Another command you might try is who, which lists the names of everyone 
who is logged in to XENIX. A typical display from the who command 
might look something like this: 

you console Jan 16 14:00 


joe ttyOl Jan16 09:11 
ann tty02 Jan 16 09:33 


The time, given in the fourth column, indicates when the user logged in; is 
the system name for each user’s terminal, where nn is a unique two-digit 
number. The console is the special name of the master terminal that is the 
default for most operations. 


If you make a mistake entering the command name, you will see a message 
on your screen. Forexample, if you enter: 


whom 
the system responds with the message: 
whom: not found 
Note that case is significant in XENIX. The commands 


who 
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and 
WHO 


are not the same; this differs from some operating systems, where case 
does not matter. : 


Now try displaying a message on your screen using the echo command. 
Type: 


echo hello world 


The Echo command does what its name implies and echoes the rest of the 
command line to your terminal: 


hello world 
Now try this: 
echo hello world > greeting. file 


This time the echo command sends its output to a new file named 
greeting. file, instead of to your terminal. Note the use of the greater-than 
sign (>) to “redirect” the output of the command. Nowenter: 


Ic 


to list just the name of the file, To look at the contents of display it by enter- 
ing: 


cat greeting. file 


Here “cat” stands for concatenate. One purpose of the cat command is to 
combine the contents of several files (that is, “concatenate)” and put them 
in some new file. However, since your terminal display is treated like any 
other file in XENIX, cat is most commonly used to display the contents of 
files on the screen. Therefore the above command sends the following out- 
put to your terminal screen: 


hello world 
To remove enter: 

rm greeting. file 
Note that XENIX command names are often shortened to mnemonic 
names. For example, cp is short for “copy’’, Is is short for “‘list”’, rm is 


short for “‘remove’’, cat is short for “concatenate”, mkdir is short for 
‘make directory”, and chmod is short for ‘“‘change mode”’. 
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2.5 Mistakes in Typing 


If you make a mistake in entering while entering a command, there are two 
ways to edit the line, provided you have not yet pressed RETURN. Pressing 
the BKSP key causes the last character entered to be erased. Backspacing 
with the BKSP key can erase characters back to the beginning of the line, 
but not beyond. Thus, if you type badly, you can correct as you go. For 
example, entering: 


ddBKSPateRETURN 
is the same as 


dateRETURN 


The XENIX kill character, Ctrl-U, erases all of the characters entered so 
far on the current input line. So, if the line is irretrievably fouled up, enter 
Ctrl-U and start the line over. 


If you must enter a BKSP or Ctrl-U as part of the text, precede it with a 
backslash (\), so that the character loses its special ““‘erase””’ meaning. 
To enter a BKSP or Ctrl-U in text, enter “\BKSP” or “\Ctrl-U”’. The system 
always prints a new line on your terminal after your Ctrl-U, even if pre- 
ceded bya backslash. Nevertheless, the Ctrl-U will have been recorded. 


To erase a backslash, backspace twice with the BKSP key, as in 
‘“\BKSPBKSP”. The backslash is used extensively in XENIX to indicate 
that the following character is in some way special. Note that the functions 
performed by BKSP and Ctrl-U are available on all XENIX systems; how- 
ever, the keys used to perform these functions may vary and can be set by 
the user with stty (C). 


2.6 Read-Ahead and Type-Ahead 


XENIX has full read-ahead, which means that you can type as fast as you 
want, whenever you want, and XENIX will remember what you have 
entered. If you enter any text while a command is displaying text on the 
screen, your input characters appear intermixed with the output characters 
on the screen, but they are stored away and interpreted in the correct 
order. Therefore, you can enter several commands (i.e., “type ahead”’) 
one after another without waiting for the first to finish. Note that this does 
not work when you log in; type-ahead does not work until after you have 
entered your password and the dollar sign ($) prompt appears. 
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2.7 Strange Terminal Behavior 


Occasionally, your terminal may act strangely. You can often fix such 
behavior by either turning your terminal off, then quickly turning it back 
on, or logging out and logging back in; this will reset your terminal charac- 
teristics. It is often helpful to enter a Ctrl-Q. This restores terminals that 
are (inadvertantly or otherwise) in a non-echoeing mode. Ctrl-S stops 
display to the screen, Ctrl-Q restarts display. If logging out and back in, 
turning the terminal off and on, and entering Ctrl-Q does not work, read 
the description of the command stty(C) in the XENIX Reference Manual 
for more information about setting terminal characteristics. Also, refer to 
the next section, “Stopping a Program.” 


2.8 Stopping a Program 


You can abort the execution of most programs and commands by pressing 
the INTERRUPT key (perhaps called DEL, DELETE, Ctrl-C, or RUBOUT 
on your terminal). The BREAK key found on many terminals can also be 
used. Inside some programs, like most text editors, entering INTERRUPT 
stops whatever the program is doing without aborting the program itself. 
Throughout this manual, when we say “send an interrupt” we mean press 
the INTERRUPT key. 


2.9 Logging Out 


To end a session with XENIX, you must log out. This is done by entering 
Ctrl-D as the first character on a line. It is not sufficient just to turn off the 
terminal, since this does not log you out. Some programs can also be 
ended by entering Ctrl-D, so beware. 
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Basic Concepts 


3.1 Introduction 


This chapter will give you an understanding of the basic concepts you need 
to function in the XENIX environment. After reading this chapter you 
should understand how the system’s files, directories, and devices are 
organized and named, how commands are entered, and how acommand’s 
input and output can be manipulated. This chapter begins with a discus- 
sion of files. 


3.2 Files 


The file is the fundamental unit of the XENIX file system. In XENIX there 
are really three different types of files: ordinary files (what we usually mean 
when we say “‘file’’), directories, and special files. Each of these types of 
files is described below. 


3.2.1 Ordinary Files 


Ordinary files typically contain textual information such as documents, 
data, or program sources. Executable binary files are also of this type. An 
ordinary file is simply a named concatenation of 8-bit bytes. Whether these 
bytes are interpreted as text characters, binary instructions, or program 
statements is up to the programs that examine them. Every ordinary file 
has the following attributes: 


—- A filename (not necessarily unique) 

— Aunique system number called an inode number 

- Asizeinbytes 

- Atimeofcreation 

—- Atimeof modification 

— Atimeof last access 

— Asetof access permissions 
Files can be protected by assigning appropriate access permissions to 
assure privacy and security. This is done by providing read-write-execute 
permissions to files so that the user can control access by the owner, bya 
group of users, and by anyone else. By default, the owner of a file is its 
creator. The owner can read the file or wnte to it. By default, other users 
can read a file owned by another, but not write to it. File permissions can 


be altered with the chmod command. This command is discussed in 
Chapter 4 of this manual. 
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3.2.2 Special Files 


Special files correspond to physical devices such as hard and floppy disks, 
lineprinters, terminals, and system memory. They are called “device spe- 
cial files”. These files are not discussed in this manual. 


3.2.3 Directory files 


Directory files are read-only files containing information about the files or 
directories that are conceptually (but not physically) contained within 
them. This information consists of the name and inode number of each file 
or directory residing within the given directory. An inode number is a 
unique number associated with any given file. All files on the system have 
inode numbers. A name/inode number pair is called a link. The ls com- 
mand is used to examine directory files and to list the information about the 
files conceptually within the named directory. With the inode number, the 
Is command can also find other information about a file. 


The nesting of directories inside other directories is the way in which 
XENIX implements its characteristic tree-structured directory system. 
Directories are discussed further in the next section. 


Like ordinary files, directories can be protected by assigning appropriate 
access permissions to assure privacy and security. This is done by giving 
read-write-search permissions to directories so that the user can control 
directory access by the owner, by a group of users, and by anyone else. 
Write permission determines whether files can be added or removed from 
a directory. By default, the owner of a directory is its creator, and the 
owner can read, create or remove files within that directory. Similarly by 
default, a user can read files within the directory of another, but not add or 
remove files. As with file permissions, directory permissions can be altered 
with the chmod command. Default permissions can be altered with the 
umask command. 


3.2.4 Directory Structure 


With multiple users and multiple projects, the number of files in a file sys- 
tem can proliferate rapidly. Fortunately, as mentioned earlier, XENIX 
organizes all files into a tree-structured directory hierarchy. This tree struc- 
ture should be thought of as a physical world in which the user can move 
from place to place. ‘‘Places” are directories. Each user of the system has 
his own personal directory. Within that directory, the user may have direc- 
tories or other subdirectories owned and controlled only by the user. 


When you log in to XENIX, you are “in” your directory. Unless you take 
special action when you create a file, the new file is created in your working 
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directory. This file is unrelated to any other file of the same name in some- 
one else’s directory. | 


A diagram of part of a typical user directory is shown in Figure 3-1. 


adam eve mary 
/ / . 
text / \ ext 
text t emp 


Figure 3-1 A Typical User Directory 


In Figure 3-1, the usr directory contains each user’s own personal 
directory. Notice that Mary’s file named text is unrelated to Eve’s. 
This is not important if all the files of interest are in Eve’s directory, 
but if Eve and Mary work together, or if they work on separate but 
related projects, this division of files becomes handy indeed. For 
example, Mary could print Eve’s text by typing: 


pr /usr/eve/text 
Similarly, Eve could find out what files Mary has by typing: 


Ic /usr/mary 


3.3 File Systems 


A file system is a set of files organized in a certain way. In XENIX, this 
set of files consists of all available resources including data files, direc- 
tories, programs, lineprinters, and disks. Thus, the XENIX file system 
is a system for accessing all system resources. 


To logically structure the resources of the system, the XENIX file sys- 
tem is organized hierarchically in an inverted “‘tree structure”. See Fig- 
ure 3-2 for an illustration of a typical tree-structured file system. In 
this typical tree of files, the root of the tree is at the top and branches 
of the tree grow downward. Directories correspond to nodes in the 
tree; ordinary files correspond to “leaves”. If a directory contains a 
downward branch to other files or directories, then those files and 
directories are “contained” in the given directory. It is possible to 
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name any file in the system by starting at the root (where the root is at 
the top) and traveling down any of the branches to the desired file. 
Similarly, you can specify any file in the system, relative to any direc- 
tory. Specification of these files depends on a knowledge of the 
XENIX naming conventions, discussed in the next section. 


/ (root) 


doug va 
/ 
er 


mail news text data 
Figure 3-2 A Typical File System 


In the typical tree-structured file system of Figure 3-2, the “tree” grows 
downward. The names bin, usr, dev, doug, and neil all represent direc- 
tories, and are all nodes in the tree. In XENIX the name of the root 
directory is given the one-character name, “/”. The names mail, 
news, text, and data all represent normal data files, and are all ‘‘leaves”’ 
of the tree. Note that the file cmd is the name of a command that can 
be executed. The name f¢ty represents a terminal and is also 
represented in the tree. 


3.4 Naming Conventions 


Every single file, directory, and device in XENIX has both a filename 
and an absolute pathname. This pathname is a map of the file or 
directory’s location in the system. The absolute pathname is unique to 
all names in the system; filenames are unique only within directories 
and need not be unique system-wide. This is similar to someone 
whose “global” name is John Albert Smith in a telephone directory, 
but who may be listed simply as John in an office phone list. 


3.4.1 Filenames 


A simple filename is a sequence of one to fourteen characters other 
than a slash (/). Every single file, directory, and device in the system 
has a filename. Filenames are used to uniquely identify directory con- 
tents. Thus, no two filenames in a directory may be the same. How- 
ever, filenames in different directories may be identical. 
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Although you can use almost any character in a filename, it is best to 
confine filenames to the alphanumeric characters and the period. 
Other characters, especially control characters, are discouraged for use 
in filenames. When a filename contains an initial period, it is “‘hid- 
den’, and is not displayed by the le command. However the Is com- 
mand will display the hidden files. The dash (—) is used in specifying 
command options, and should be avoided when naming files. In addi- 
tion, the question mark (?), the asterisk (*), brackets ({ and ]), and all 
quotation marks should never be used in filenames, since they are 
treated specially when entering commands. 


3.4.2 Pathnames 


A pathname is a sequence of directory names followed by a simple 
filename, each separated from the previous name by a slash. If a path- 
name begins with a slash, it specifies a file that can be found by begin- 
ning a search at the root of the entire tree. Otherwise, files are found 
by beginning the search at the user’s current directory (also known as 
the working directory). The current directory should be thought of as 
your location in the file system. Think of it as a physical place. When 
you change your current directory you are > moving to some other direc- 
tory or place in the file system. | 


A pathname beginning with a slash is called a full (or absolute) path- 
name because it does not vary with regard to the user’s current direc- 
tory. A pathname not beginning with a slash is called a relative path- 
name, because it specifies a path relative to the current directory. The 
user may change the current directory at any time by using the cd com- 
mand. 


3.4.3 Sample Names 


Some sample names follow: 


/ The absolute pathname of the root directory of the 
entire file system. 


/bin The directory containing most of the frequently 
used XENIX commands. 


/usr The directory containing each user’s personal 
directory. The subdirectory, /usr/bin contains fre- 
quently used XENIX commands not in /bin. 


/dev The directory containing files corresponding to 
physical devices (e.g., terminals, lineprinters, and 
disks). 
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/dev/console The name of the system master terminal. 
/dev/tty The name of the user’s terminal. 


/lib The directory containing files used by some stan- 
dard commands. 


/tmp This directory contains temporary scratch files. 


/usr/joe/project/A 
A typical full pathname; this one happens to be a 
file named A in the directory named project belong- 
ing to the user named joe. 


bin/x A relative pathname; it names the file x in sub- 
directory bin of the current working directory. If 
the current directory is /, it names /bin/x. If the 
current directory is /usr/joe, it names 
/usr/joe/bin/x. 


file1 Name of an ordinary file in the current directory. 


When using the XENIX system, each user resides “in” a directory 
called the current directory. All files and directories have a “‘parent”’ 
directory. This directory is the one immediately above, which “con- 
tains” the given file or directory. The XENIX file system provides spe- 
cial shorthand notations for this directory and for the current direc- 


tory: 


The shorthand name of the current directory. Thus ./filexxx 
names the same file as filexxx, if such a file exists in the 
current directory. . 


The shorthand name of the current directory’s parent direc- 
tory. The shorthand name ../.. refers to the directory that is 
two levels ‘‘above” the current directory 


3.4.4 Special Characters 


XENIX provides a pattern-matching facility for specifying sets of 
filenames that match particular patterns. For example, examine the 
problem that occurs when naming the parts of a large document, such 
as a book. Logically, it can be divided into many small pieces such as 
chapters or sections. Physically, it must be divided too, since the 
XENIX editor vi cannot handle really big files. 
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Thus, you should divide a large document into several files. The 
points at which the document is divided should follow a logical order. 
You might have a separate file for each chapter: 
chapl 
chap2 
Or, if each chapter is broken into several files, you might have: 
chap1.1 
chap1.2 
chap1.3 
chap2.1 
chap2.2 
You can then tell at a glance where a particular file fits into the whole. 
There are other advantages to a systematic naming convention that are 
not so obvious. What if you want to print the whole book on the line- 
printer? You could enter: 
Ipr chap1.1 chap1.2 chap1.3 ... 
but you will tire of this quickly and will probably even make mistakes. 
Fortunately, there is a shortcut: a sequence of names containing a 
common pattern can be specified with the use of special characters. 
The special characters discussed in this chapter are: 
* Matches zero or more characters 
[] Matches any character inside the brackets 
? Matches any single character 
For example, you can enter: 
Ipr chap* 
The asterisk (*), sometimes called “star” in XENIX, means “zero or 
more characters of any type’’, so this translates into “‘send all files 


whose names begin with the word “chap” to the lineprinter”’’. 


This shorthand notation is not a unique property of the Ipr command; 
it can be used in any command. 
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Using this fact, you can list the names of the files in the book by typ- 
ing: 


ls chap* 
This produces 
chap1.1 


chap1.2 
chap1.3 


The star is not limited to the last position in a filename; it can be used 
anywhere and can occur several times. A star by itself matches all 
filenames not containing slashes or beginning with periods, so: 

cat * 


displays all files in the current directory on your terminal screen. 


The star is not the only pattern-matching feature available. Suppose 
you want to print only chapters 1 through 4, and 9. You can say: 


lpr chap[12349]* 
The brackets ({ and ]) mean “match any of the characters inside the 
brackets.” A range of consecutive letters or digits can be abbreviated, 
so you can also do this with: 

lpr chap[1-49]* 
(Note that this does not match forty-nine filenames, but only five.) 
Letters can also be used within brackets: “[a—z]” matches any charac- 
ter in the range “a” through “z”. 
The question mark (?) matches any single character, so 

ls ? 
lists all files that have single-character names, and 


ls -1 chap?.1 


lists information about the first file of each chapter (i.e., chapl.1, 
ehap2.1,..+): 


If you need to turn off the special meaning of any of the special char- 


acters (*, ?, and [... ]) enclose the entire argument in single quotation 
marks. 
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For example, the following command will print out only files named 
‘*?” rather than all one-character filenames: 


le a 


Pattern-matching features are discussed further in Chapter 4 of the 
XENIX User’s Guide, ‘‘The Shell.”’ 


3.5 Commands 


Commands are used to invoke executable programs. When you enter 
the name of a command, XENIX reads the command line that you 
have entered, looks for a program with the given name, and then exe- 
cutes the program if it finds it. Command lines may also contain argu- 
ments that specify options or files that the program may need. The 
command line and command syntax are discussed in the next two sec- 
tions. 


3.5.1 Command Line 


Whether you are entering commands at a terminal, or XENIX is read- 
ing commands from a file, XENIX always reads commands from com- 
mand lines. The command line is a line of characters that is read by 
the shell command interpreter to determine what actions to perform. 
This interpreter, or “‘shell” as it is known, reads the names of com- 
mands from the command line, finds the executable program 
corresponding to the name of the command, then executes that pro- 
gram. When the program finishes executing, the shell resumes reading 
the command line. Thus, when you are entering at a terminal, you are 
editing a line of text called the command-line buffer that becomes a 
command line only when you press RETURN. This command-line 
buffer can be edited with the BKSP and Ctrl-U keys. Pressing 
RETURN causes the command-line buffer to be submitted to the shell 
as a command line. The shell reads the command line and executes the 
appropriate command. If you press INTERRUPT before you press 
RETURN, the command-line buffer is erased. Multiple commands can 
be entered on a single command line provided they are separated by a 
semicolon (;). For example, the following command line prints out 
the current date and the name of the current working directory: 


date ; pwd 
Commands can be submitted for processing in “the background” by 
appending an ampersand (&) to the command line. This mode of exe- 


cution is similar to “batch” processing on other systems. The main 
advantage to placing commands in the background is that you can exe- 
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cute other commands from your terminal in the “foreground” while 
the background commands execute. Thus: 


du /usr >diskuse& 
determines the disk usage in the directory /usr, a fairly time-consuming 
operation, without tying up your terminal. Note that the output is 
placed in the file diskuse by redirecting output with the greater-than 
symbol. Redirection is discussed in Section 3.6.1. 
3.5.2 Syntax 
The general syntax for commands is as follows: 

cmd [ switches }[ arguments ] [ filenames ] 
By convention, command names are lowercase. Switches, also called 
options, are flags that select various options available when executing 
the command. They are optional and usually precede other arguments 
and filenames. Switches consist of a dash prefix (—) and an identifying 
letter. For example, the Ils command’s —I switch (pronounced “minus 
ell” ) specifies a long directory listing and the command 

ls -r 
specifies a directory listing in reverse alphabetical order. In some 
cases, switches can be grouped to form a single switch argument. For 
example, the command 

ls —rl 
is really a combination of two switches, where the —rl switch selects 
the option that lists all files in the directory in both reverse alphabeti- 
cal order and with the long format. 
Sometimes multiple switches must be given separately, as in: 

copy —v —a source destination 
Here the —v switch specifies the “verbose” option, which reports 
copying as it happens. The —a switch tells the copy command to ask 
the user for confirmation before copying the source to the destination. 


Other arguments, such as search strings, can also be given, as in: 


grep string of text’ outfile 
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In the above example, 
‘string of text’ 


is a single argument and is the search string the grep command 
searches for in the file outfile. Filename is the argument that specifies 
the name of a file required by the command. 


Most commands are executable programs compiled by the C compiler 
or by some other language compiler. Some commands are executable 
command files called “shell procedures”. Shell procedures are dis- 
cussed in Chapter 4 of the XENIX User’s Guide, ‘“The Shell.” 


3.6 Input and Output 


By default, XENIX assumes that terminal input comes from the termi- 
nal keyboard and output goes to the terminal screen. To illustrate typ- 
ical command input and output, enter: 


cat 


This command now expects input from your keyboard. As input, it 
accepts as many lines of text as you enter until you press Ctrl-D as an 
end-of-file or end-of-transmission indicator. 


For example, enter: 


this is two linesRETURN 
of inputRETURN 
Ctrl-D 


When you press Ctrl-D, input ends and output begins. The cat com- 
mand immediately outputs the two lines you entered-since output is 
sent to the terminal screen by default, that is where the two lines are 
sent. Thus, the complete session will look like this on your terminal 
screen: 


$ cat 

this is two lines 
of input 

this is two lines 
of input 


The flow of command input and output can be “redirected” so that 
input comes from a file instead of from the terminal keyboard and out- 
put goes to a file or lineprinter, instead of to the terminal screen. In 
addition, “pipes” can be created that allow the output from one 
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command to become the input to another. Redirection and pipes are 
discussed in the next two subsections. 


3.6.1 Redirection 


In XENIX a file can replace the terminal for either input or output. 
For example: 


Is 
displays a list of files on your terminal screen. But if you say: 
ls >filelist 


a list of your files is placed in the file filelist (which is created if it does 
not exist). The symbol for output redirection, the greater-than sign 
(>), means “put the output from the command into the following file, 
rather than display it on the terminal screen.” As another example of 
output redirection, you can combine several files into one by capturing 
the output of cat in a file: 


cat f1 f2 £3 >temp 


The output append symbol (>>) operates very much like the output 
redirection symbol, except that it means “add to the end of’. So: 


cat file1 file2 file >>temp 


means “concatenate filel, file2, and file3 to the end of whatever is 
already in temp, instead of overwriting and destroying the existing con- 
tents.” As with normal output redirection, if temp doesn’t exist, it is 
created for you. 


In a similar way, the input redirection symbol (<) means “take the 
input for a program from the following file, instead of from the termi- 
nal” . Thus, you could make a script of editing commands and put 
them into a file called script. Then you could execute the commands 
in the script on a file by typing: 

ed file <script 


As another example, you could use ed to prepare a letter in the file 
letter.txt, then send it to several people with: 


mail adam eve mary joe <letter.txt 
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3.6.2 Pipes 


One of the major innovations of the XENIX system is the concept of a 
“pipe”. A pipe is simply a way to connect the output of one com- 
mand to the input of another, so that the two run as a sequence of 
commands called a pipeline. 


For example: 

sort frank.txt george.txt hank.txt 
combines the three files named frank.txt, george.txt, and hank.txt, then 
sorts the output. Suppose that you want to then find all unique words 
in these files and view the result. You could enter: 

sort frank.txt george.txt hank.txt >temp1 

uniq <templ >temp2 

more temp2 

rm temp1 temp2 
But this is more work than is necessary. What you want is to take the 
output of sort and connect it to the input of uniq, then take the out- 
put of uniq and connect it to more. You would use the following pipe: 

sort frank.txt george.txt hank.txt | uniq | more 
The vertical bar character (|) is used between the sort and uniq com- 
mands to indicate that the output from sort, which would normally 
have been sent to the terminal, is to be redirected from the terminal to 
the standard input of the uniq command, which in turn sends its out- 
put to the more command for viewing. , 
There are many other examples of pipes. For example: 

ls | pr -3 
formats and paginates a list of your files in three columns. The pro- 
gram we counts the number of lines, words, and characters in its 
input, and who prints a list of users currently logged on, one per line. 
Thus, 

who | we 
tells how many people are logged in, and 


ls | we 


counts the number of files in the current directory. 
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Any program that reads from the terminal keyboard can read from a 
pipe instead. Any program that displays output to the terminal screen 
can send input to a pipe. You can have as many elements in a pipeline 
as you wish. 
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4.1 Introduction 


This chapter explains how to perform common tasks on XENIX. The indi- 
vidual commands used to perform these tasks are discussed more 
thoroughly in the XENIX Reference Manual. 


4.2 Gaining Access to the System 


To use the XENIX system, you must first gain access to it by logging in. 
When you log in you are placed in your own personal working area. Log- 
gingin, changing your password, and logging out are described below. 


4.2.1 Logging In 


Before you can log in to the system, you must be given a system “account.” 
Your name must be added to the user list, and you must be given a pass- 
word and a mailbox. 


Depending on how your system is administered, you may have to add your 
name to the user list yourself, or someone else may be assigned this task. If 
you must add your own account to the system, see the XENIX Operations 
Guide and mkuser(C) in the XENIX Reference Manual for more informa- 
tion. This section assumes your account has already been set up. 


Normally, the system sits idle and the prompt “‘login:” appears on the ter- 
minal screen. If your screen is blank, or displays nonsense characters, 
press the INTERRUPT key a few times. 


When the “login:” prompt appears, follow these steps: 


1. Enter your login name and press RETURN. If you make a mistake, 
press Ctrl-U to start the line again. After you press RETURN the 
word “‘Password:” appears On your screen. 


2. Enter your password carefully, then press RETURN. The letters do 
not appear On your screen as you enter, and the cursor does not 
move. If you make a mistake, press RETURN to restart the login 
procedure. 


If you have entered your login name and password correctly the “prompt 
character” appears on the screen. This is usually a dollar sign($). The 
prompt tells you that the XENIX system is ready to acccept commands 
from the keyboard. 
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If you make a mistake, the system displays the message: 


Login incorrect 
login: 


If you get this message, follow the above procedure again. You must enter 
all the letters of your user name and password correctly before you are 
given access to the system; XENIX does not allow you to correct your mis- 
takes when entering your password. 


Depending on how your system is set up, after you log in you may see a 
“banner” that says something like “Welcome to XENIX”, or an 
announcement that is of interest to all users. 


4.2.2 Logging Out 
The logout procedure is simple-all you need to do is press: 
Ctrl-D 


alone on aline. In general, Ctrl-D signifies the end-of-file in XENIX, and is 
often used within programs to signal the end of input from the keyboard. 
In such cases, Ctrl-D will not log you out; it will simply terminate input to a 
particular program if you are within that program. This means that it may 
sometimes be necessary to press Ctrl-D several times before you can log 
yourself out. For example, if you are in the mail program you must press 
Ctrl-D once to exit the mail program, then again to log out. 


4.2.3 Changing Your Password 


To prevent unauthorized users from gaining access to the system, each 
authorized user must have a password. When you are first given an account 
on a XENIX system you are assigned a password by the system administra- 
tor. Some XENIX systems require you to change your password at regular 
intervals. Whether yours does or not, it is a good idea to change your pass- 
word regularly to maintain system security. This section tells you how to 
change your password. 


Use the passwd command to change your password. Follow these steps: 
1. Enter: 
passwd 


and press RETURN. 
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The following message appears: 


Changing password for user: 
Old password: 


2. Carefully enter your old password. It is not displayed on the screen. 
If you make a mistake, press RETURN. The message “Sorry” 
appears, then the system prompt. Begin again with step 1. 

3. When you have entered your old password the message: 

New password: 
appears. Enter your new password and press RETURN. 
4. The message: 


Retype new password: 


appears. Enter your new password again. If you make a mistake, 
press RETURN. The message: 


Mismatch — password unchanged 


appears, and you must begin again with step 1. When you have com- 
pleted the procedure, the system prompt appears. 


4.3 Configuring Your Terminal 


On most systems, the standard console terminal is already configured for 
use with XENIX. However, other terminals of various types may be con- 
nected to a XENIX system. In these cases it is important to know howto set 
terminal options and how to specify the terminal you are using. You may 
also want to change the standard configuration of the standard console ter- 
minal. The following section discusses these topics. 


4.3.1 Changing Terminals 


If you ever need to login to XENIX ona terminal of a type different than the 
terminal you normally use, you may need to change the shell TERM vari- 
able. This is normally set to the proper terminal when you login, but if you 
switch terminal types you will have to reset the TERM variable. To reset 
this variable, enter the following line at command level: 


TERM =termname 
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where termname is the name of a known terminal. A list of known termi- 
nals is described in terminals(M). A variety of terminals are supported; 
terminal capabilities are listed in the system file /etc/termcap. 


You can change the terminal type displayed each time you login. Use a text 
editor to change the .profile file in your home directory. Locate the tset 
line that looks something like this: 


eval ‘tset -m :\?unknown-s -r -Q* 


Change unknown in this line to the terminal type of your terminal. For 
example, if you normally login on avt100 terminal, change the line to: 


eval ‘tset -m :\?vt100-s -r -Q‘ 
Each time you login you then see the message: 
TERM = (vt100) 


Press RETURN and the terminal type is set to vt100, or enter another termi- 
nal type and press RETURN. 


4.3.2 Setting Terminal Options 


There are a number of terminal options that can be set with the command 
stty. When entered without parameters, stty displays the current terminal 
settings. For example, typical output might look like this: 


speed 9600 baud 
erase “h’; kill *w’ 
even —nl 


Each of the above characteristics can be set with stty. For more informa- 
tion, see stty(C) in the XENIX Reference Manual. 

4.4 Editing the Command Line 

When you sit in front of a terminal and enter commands at your keyboard, 
there are a number of special keys that you can use. The most useful ones 
are described below. 

4.4.1 Entering a Command Line 

From your terminal, entering acommand line consists of typing characters 
then pressing RETURN. Once you have pressed RETURN the computer 


reads the command line and commands specified on that line are executed. 
You may enter as many command lines as you want without waiting for 
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commands to complete, because XENIX supports type-ahead of charac- 
ters. 
4.4.2 Erasing a Command Line 
When entering commands, typing errors are bound to occur. To erase the 
current command line, press Ctrl-U. 
4.4.3 Halting Screen Output 
In many cases, you will be examining the contents of a file on the terminal 
screen. For longer files, the contents will often scroll off the screen faster 
than you can examine them. To temporarily halt a program’s output to the 
terminal screen, press Ctrl-S. To resume output, press Ctrl-Q. 
4.5 Manipulating Files 
File manipulation (creating, displaying, combining, copying, moving, 
naming, and deleting files), is one of the most important capabilities an 
operating system provides. The XENIX commands that perform these 
functions are described in the following sections. 
4.5.1 Creating a File 
To create a file and place text in it, use the editor vi, described in Chapter 5 
of this manual, “‘Vi: A Text Editor.” If for some reason you wish to create 
anempty file, enter: 

> filename 
where filename is the name of the empty file. In general, new files are 
created by commands as needed. 


4.5.2 Displaying File Contents 


The more command displays the contents of a file one screenful at a time. 
It has the form: 


more options filename 


More is useful for looking at a file when you do not want to make changes to 
it. Forexample, to display the contents of the file memos, enter: 


more memos 
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More can be invoked with options that control where the display begins, 
and how the file is displayed. 


These options include: 


+linenumber 
Begins the display at the line in the file designated by 
linenumber. 


+/text 
Begins the display two lines before text, where text is a word or 
number. If text is two or more words, they must be enclosed in 
double quotation marks. 


=e Redraws the screen instead of scrolling. 
op 5 Displays control characters, which are normally ignored by 
more. 


To begin looking at the file memo at the first occurrence of the words “net 
gain’’, forexample, enter: 


more +/"net gain" memo 

If the file is more than one screenful long, the percentage of the file that 
remains is displayed on the bottom line of the screen. To look at more of 
the file, use the following scrolling commands: 

RETURN Scrolls down one line. 

d Scrolls down one-half screen. 

SPACE  Scrollsdownafullscreen. 

nSPACE _ Scrollsdownn lines. 

: Repeats the previous command. 
You cannot scroll backward, toward the beginning of the file. 
You can search forward for patterns in more with the slash (/) command. 


For example, to search for the pattern “net gain’’, enter: 


/net gain/ 
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and press RETURN. More displays the message: 
skipping... 
at the top of the screen, and scrolls to a location two lines above “net gain.” 


If you are looking at a file with more and decide you want to change the file, 
you can invoke the vieditor by pressing: 


Vv 
See Chapter 5, “Vi: A Text Editor,” for information on using vi. 


More quits automatically when it reaches the end of a file. To exit more 
before the end of a file, enter: 


q 


The head and tail commands display the first and last ten lines of a file, 
respectively. They are useful for checking the contents of a particular file. 


For example, to look at the first ten lines of the file memo, enter: 

head memo 
You can also specify how many lines the head and tail commands display. 
For example: 

tail—4 memo 
displays the last four lines of memo. 
The cat command also displays the contents of a file. Cat scrolls the file 
until you press Ctrl-S to stop it. Pressing Ctrl-Q will continue the scrolling. 
Cat stops automatically at the end of a file. If you wish to stop the display 
before the end of the file, press INTERRUPT. To display the contents of 
one file, enter: 

cat filel 


To display the contents of more than one file, enter: 


cat filel file2 file3 


4-7 


Introduction to XENIX 


4.5.3 Combining Files 


The cat command is frequently used to combine files into some other new 
file. 


Thus, to combine the two files named file1 and file2, into a new file named 
bigfile, enter: 


cat file1 file2 >bigfile 
Note here that we are putting the contents of the two files into a new file 
with the name bigfile. The greater than sign ( > ) is used to redirect output 
of the catcommand to the new file. 


You can also use cat to append one file to the end of another file. For exam- 
ple, to append file J to file 2, enter: 


cat filel >> file2 


The contents of file 1 are added to file2. File 1 still exists as a separate entity. 


4.5.4 Moving a File 


The mv command moves a file into another file in the same directory, or 
into another directory. 


For instance, to move a file named text to a new file named book, enter: 
mv text book 


After this move is completed, no file named text will exist in the working 
directory, because the file has been renamed book. 


To move a file into another directory, give the name of the destination 
directory as the final name in the mv command. For instance, to move file] 
and file2 into the directory named /tmp, enter: 


mv file1 file2 /tmp 
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The two files you have moved no longer exist in your working directory, but 
now exist in the directory /tmp. The above command has exactly the same 
effect as entering the following two commands: 


mv filel /tmp/file1 
mv file2 /tmp/file2 


The mv command always checks to see if the last argument is the name of a 
directory and, if so, all files designated by filename arguments are moved 
into that directory. 


4.5.5 Renaming a File 


To rename a file, simply “move” it to a file with the new name: the old 
name of the file is removed. Thus, to rename the file anon to Johndoe, 
enter: 


mv anon johndoe 


Note that moving and renaminga file are essentially identical operations. 


4.5.6 Copying a File 


There are two forms of the ep command: one in which files are copied into 
a directory, and another in which a file is copied to another file. Thus, to 
copy three files into a directory named filer, enter: 


cp file1 file2 file3 filer 


In the above command, three files are copied into the directory filer; the 
Original versions still reside in the working directory. Note that the 
filenames are identical in the two directories. Like the mv command, ep 
always checks to see if the last argument is the name of a directory, and, if 
so, all files designated by filename arguments are copied into that direc- 


tory. 
To create two copies of a file in your own working directory, you must 
rename the copy. To do this, the copy command can be invoked as fol- 
lows: 

cp file filecopy 
After the above command has executed, two files with identical contents 


reside in the working directory. To learn how to copy directories, see sec- 
tion 4.6.7, “Copying a Directory’’, later in this chapter. 
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4.5.7 Deleting a File 
To delete or remove files, enter: 
rm file1 file2 


In the above command, the files file] and file2 are removed from your 
working directory. 


The command: 
rm —i filel file2 


allows you to interactively remove files by asking you if you really want to 
delete each of the files file] and file2. If you press y followed bya RETURN, 
the given file is removed; if you press 7 the file is left untouched. This com- 
mand is useful when cleaning up a directory that contains many files. 


4.5.8 Finding Files 


The find command searches for files that have a specified name. Find is 
useful for locating files that have the same name, or just for finding a file if 
you have forgotten which directory it is in. 


The command has the form: 
find pathname —name filename —print 


The pathname is the pathname of the directory you want to search. Find 
searches recursively, that is, it starts at the named directory and searches 
downward through all files and subdirectories under the directory specified 
in pathname. 


The ‘“—name” option indicates that you are searching for files that have a 
specific filename. (There are other search conditions you can use with find ; 
see find(C) in the XENIX Reference Manual.) 


Filename is the name of the file you are searching for. 


The ‘“—print” option indicates you want to print the pathnames of all the 
files that match filename on your terminal screen. You may direct this out- 
put to a file instead of your screen with the output redirection symbol, >. 
(There are other actions that can be performed with find, such as removing 
and moving files; see find(C) in the XENIX Reference Manual .) For exam- 
ple, the following command finds every file named memo in the directory 
/usr/joe and allits subdirectories: 


find /usr/joe -name memo —print 
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The output might look like this: 


/usr/joe/memo 
/usr/joe/accounts/memo 
/usr/joe/meetings/memo 
/usr/joe/mail/memo 


4.5.9 Linking a File to Another File 


The In command joins two files in different directories so that when the file 
is changed in one directory, it is also changed in the other directory. This 
can be useful if several users need to share information, or if you want a file 
to appear in more than one directory. Thiscommand has the form: 


In file newfile 


where file is the original file, and newfile is the new, linked file. For exam- ) 
ple, the following command links memos in /usr/joe to joememos in 
/usr/mary: 


In /usr/joe/memos /usr/mary/joememos 


Whenever /usr/joe/memos is updated, the file /usr/mary/joememos is also 
changed. 


When you link files a name is associated with an inode. An inode specifies 
a unique set of data on the disk. One or more names can be associated with 
this data. Thus, the above command assures that the files dir1/filel and 
dir2/file2 have identical contents. 


There are three things to remember about linking files that are not immedi- 
ately obvious: 


1. Linking large sets of files to other parallel files can save a consider- 
able amount of disk space. 


2. Linking files used by more than one person is risky, because any 
party can alter the file and thus affect the contents of all files linked 
to it. 


3. Removing a file from a directory does not remove other links to the 
file. Thus the file is not truly deleted from the system. For example, 
if you delete a file that has 4 links, 3 links remain. 

For more information about linking see In(C) in the XENIX Reference 
Manual. 
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4.6 Manipulating Directories 
Because of the hierarchical organization of the file system, there are many 
directories and subdirectories in the XENIX system. Within the file system 
are directories for each user of the system. Within your user directory you 
can create, delete, and copy directories. Commands that let you manipu- 
late directories are described in the following sections. 
4.6.1 Printing the Name of Your Working Directory 
All commands are executed relative to a “‘working”’ directory. The name 
of this directory is given by the pwd command, which stands for “print 
working directory.” For instance, if your current working directory is 
/usr/joe, when you enter: 

pwd 
you will get the output: 

/usr/joe 
You should always think of yourself as residing “in” your working direc- 
tory. 
4.6.2 Listing Directory Contents 
You can list the contents of a directory with the le command. This com- 
mand sorts the names of files and directories in a given directory, and lists 
them in columns. If no directory name is given, Ic lists the contents of the 
current directory. The le command has the form: 

lc options name 


For example, to list the contents of the directory work, enter: 


Ic work 


Your output might look like this: 


accounts meetings notes 
mail memos todo 


4-12 


Tasks 


If no name is specified, Ie lists the contents of the current directory. If 
accounts is the current directory, for example, the command: 


lists the names of the files and subdirectories in that directory. 


The following options control the sort order and the information displayed 
by the le command: 


— 2 


=f 


sae 


Lists all files in the directory, including the “hidden” files 
(filenames that begin with a dot, such as. profile and .mailrc). 


Lists names in reverse alphabetical order. 


Lists names in order of last modification, the latest (most recently 
modified) first. When used with the —r option, lists the oldest 
first. 


Lists all files and directories in the current directory, plus each file 
and directory below the current one. The “‘R”’ stands for “‘recur- 
Sive.”’ 


Marks directories with a backslash(\) and executable files with an 
asterisk (*). 


The Is —1 command gives a “long” listing of a directory, producing an out- 
put that might look something like this: 


total 501 

G€7WKt-k--~ “2 boris -grpl Ain Bape S 14233 dirt 
Ciwsr-x--— 2 enid grpl 212 Apr § 14:33 dirz 
COWs TS — 2 Aris grpl 592 Apr 6 11:12 dir3 
“Let ===> L-olal grp2 262 Apr 7 15:82 triel 
“{w-t----— b-Giat grp2 72 Ape- F £3750 £riez 
ayer =——= 1 olaf grp2 1403 Apr 1 13:22 file3 
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Reading from left to right, the information given for each file or direc- 
tory includes: 

— Permissions 

— Number of links 

— Owner 

— Group 

— Size in bytes 

— Time of last modification 

— Filename 


The information in this listing and how to change permissions are dis- 
cussed below in Section 4.8, “Using File and Directory Permissions.” 


For more information about listing the contents of a directory, see 
Is(C) in the XENIX Reference Manual. 
4.6.3 Creating a Directory 
To create a subdirectory in your working directory, use the mkdir com- 
mand. For instance, to create a new directory named phonenumbers, 
simply enter: 

mkdir phonenumbers 
After this command has been executed, a new empty directory will 
exist in your home directory. 
4.6.4 Removing a Directory 
To remove a directory located in your working directory, use the rmdir 
command. For instance, to remove the directory named 


phonenumbers from the current directory, simply enter: 


rmdir phonenumbers 
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Note that the directory phonenumbers must be empty before it can be 
removed; this prevents catastrophic deletions of files and directories. 
If you want to live dangerously, it is possible to recursively remove the 
contents of a directory using the rm command, but that will not be 
explained here. See rm(C) in the XENIX Reference Manual for more 
information. 

4.6.5 Renaming a Directory 


To rename a directory, use the mv command. For instance, to rename 
the directory little.dir to big.dir, enter: 


mv little.dir big.dir 


This is a simple renaming operation; no files are moved. 


4.6.6 Moving a Directory 


The mv command also moves directories. This command has the 
form: 


mv Oldirectory newdirectory 
where Newdirectory is a directory that already exists. 


For example, to move the directory /usr/joe/accounts into 
/usr/joe/overdue enter: 


mv /usr/joe/accounts /usr/joe/overdue 


The new pathname of /usr/joe/accounts is /usr/joe/overdue/accounts. 


4.6.7 Copying a Directory 
The copy command copies directories. This command has the form: 
copy options olddir newdir 


To copy all the files in the directory /usr/joe/memos into /usr/joe/notes 
enter: 


copy /usr/joe/memos /usr/joe/notes 
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The files in /usr/joe/memos are copied into /usr/joe/notes. The copy 
command has the following options: 


-| Links the copied files to the original. 


-m Gives the copied files the same modification dates as the origi- 
nal files. 


-r Copies the directory recursively, i.e., copies all the directories 
under the named directory. 
4.7 Moving in the File System 
When using the XENIX system, it helps to imagine a large tree struc- 
ture of files and directories. Each directory should be thought of as a 
place that you can move into or out of. At all times you are ““some- 
place” in the tree structure. This place is called either your working 
directory or current directory. The commands used to find out where 
you are and to move around in the tree structure are discussed below. 
4.7.1 Finding Out Where You Are 
Your current location in the file system is the name of the working 
directory. You can find out this name by using the pwd command, 
which stands for “print working directory.” For example, if you are in 
the directory /usr then entering the command: 
pwd 


prints out the name: 


/usr 


4.7.2 Changing Your Working Directory 

Your working directory represents your location in the file system: it is 
“where you are” in XENIX. To alter this location in the XENIX file 
system, use the change directory (cd) command: 


cd 


This changes your working directory to your home directory. To move 
to any other directory, specify that directory as an argument to cd. 
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For instance, the following command: 
cd /usr 
moves you to the /usr directory. Because you are always “in” your 


working directory, changing working directories is much like “travel- 
ing” from directory to directory. 


To move up one directory from your current directory, enter: 


Gs 


For example, the above command would move you from the directory 
/usr/joe/work to /usr/joe. Similarly, the command: 


cd ../.. 


would move you from the directory /usr/joe/work to /usr, moving you 
up two directories. 


4.8 Using File and Directory Permissions 


The XENIX system allows the owner to restrict access to files and 
directories, limiting who can read, write and execute files owned by 
him. To determine the permissions associated with a given file or 
directory, use the Is —1 command. The output from the Is —1 com- 
mand should look something like this: 


total 501 

adrwxr-xz--~ 2 boris grpi £ie Apr S 142733 dist 

drwxr-x--- 2 enid grpl zI2 Apr 5:34:33. dir2 

GrwWKI-e-=- 2 isis. grpl 292 Apr 6 11512 dir3 

=1w-t---+= 1 olaf grp2 2$2.Apr.27 15:11-.filel 
+fWo f= === 1 olaf grp2 72 Apr 7 13:50 file2 
-{Wf----= 1 olaf grp2 1403 Apr 1 13:22 file3 


Permissions are indicated by the first ten characters of the output. The 
permissions for dirl, the first file in the above list, are: | 


drwxr-x--- 


The first character indicates the type of file and must be one of the fol- 
lowing: 


_ Indicates an ordinary file. 


4-17 


Introduction to XENIX 


S 


Pp 


Indicates a directory. 


Indicates a character special device such as a lineprinter or 
terminal. 


Indicates a block special device such as a hard or floppy disk. 


Indicates a name special file (i.e., a semaphore used for con- 
trolling access to some resource). 


Indicates a shared deta file. 


Indicates a named pipe. 


From left to right, the next nine characters are interpreted as three sets of 
three permissions each. Each respective set of three indicates the follow— 
ing permissions: 


— Owner permissions 


— Group permissions 


— Allother user permissions 


Within each set, the three characters indicate permission to read, to write, 

and to execute the file as a command, respectively. For a directory, “exe- 
cute” permission means permission to search the directory for any 

included files or directories. 


Ordinary file permissions have the following meanings: 


r 


Ww 


X 


The file is readable. 
The file is writeable. 
The file is executable. 


The indicated permission is not granted. 


For directories, permissions have the following meanings: 


r 
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Files can be listed in the directory; the directory must also 


66,99 


have “‘x”’ permission. 


Files can be created or deleted in the directory; as with “r’’, 


6C.,99 


the directory itself must also have “x” permission. 
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xX The directory can be searched. A directory must have ‘‘x” 
permission before you can move to it with the cd com- 
mand (i.e., cd to it), access a file within it, or list the files 


66.99 


in it. Remember that a user must have “x” permission to 
do anything useful to the directory. 


The following are some typical directory permission combinations: 


drwxr-x--- 


drwx--x--x 


No access at all. This is the mode that denies 
access to the directory to a class of users. 


Allows access by the owner to use Ic, create files, 
delete files, access files (subject to file permis- 
sions), and ed to the directory. This is the typical 
permission for the owner of a directory. 


Allows access by members of the group to use le, 
and access files subject to file permissions. Group 
members can ed to this directory, but cannot 
create or delete files in it. This is the typical per- 
mission an owner gives to others who need access 
to files in his directory. 


With these permission settings users other than the 
owner cannot use Ie but can cd to the directory. 
Other users can only access a file within this direc- 
tory by its exact name; they cannot use special 
characters. Files cannot be created or deleted in 
the directory by anyone except the owner. This 
mode is rarely used, but can be useful if you want 
to give someone access to a specific file in a direc- 
tory without permitting access to other files in the 
Same directory. 


This chapter discusses ordinary files, executable files, and directories 
only. For information about other types of files, see J/s(C) in the 
XENIX Reference Manual. 


4.8.1 Changing Permissions 


The chmod command changes the read, write, execute, and search 
permissions of a file or directory. This command is useful if you have 
created a file in one mode, but want to give others permission to read, 


write or execute it. 
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The chmod command has the form: 
chmod instruction filename 

The instruction segment of the command indicates which permissions 
you want to change for which class of users. There are three classes of 
users, and they are are indicated as follows: 

u_ User, the owner of the file or directory 

g Group, the group the owner of the file belongs to 

o Other, all users of the system 

a All classes of users 


There are three types of permissions, as follows: 


r Read, which allows permitted users to look at but not change or 
delete the file. 


w Write, which allows permitted users to change or even delete 
the file. 


x Execute, which allows permitted users to execute the file as a 
command. 


For example, assume file] exists with the following permissions: 

-[Tw-r = 
In the above example, the owner of the file has read and write permis- 
sion, group members have read permission, and others have no access 
at all. 
To give filel read permission for all classes of users, enter: 


chmod a+r filel 


In the instruction segment of the command (atr) the “a” stands for 
“all 


The resulting permissions are: 


-rw-I--r-- 
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For file] with the attributes: 


The following command gives write and execute permissions to 
members of a group only: 


chmod g+wx filel 
This command would alter the permission attributes so they look like 
this: 

-I'W--Wx--- 


To remove write and execute permission by the user (owner) and 
group associated with filel, enter: 


chmod ug-wx filel 


4.8.2 Changing Directory Search Permissions 

Directories also have an execute permission. This attribute signifies 
search permission, rather than execute permission, since directories 
cannot be executed. If this permission is denied to a particular user, 
then that user cannot even list the names of the files in the directory. 


For example, assume that the directory dirl has the following attri- 
butes: 


drwxr-xr-x 

To remove search permission for other users to examine dir1, enter: 
chmod o-xr dirl 

The new attributes for dirl are: 


drwxr-x--- 
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4.9 Processing Information 

In many cases, files will contain information that you may want to pro- 
cess. Various utility programs exist on XENIX to process information. 
A set of these programs and their uses are described in the following 
sections. 


4.9.1 Comparing Files 


To compare two text files use the diff command to print out those lines 
that differ between the files that you specify. 


For example, suppose that a file named men has the contents: 
Now is the time for all good men to 
Come to the aid of their party. 

and that a file named women has the following contents: 


Now is the time for all good women to 
Come to the aid of their party. 


If this is the case, then the command: 


diff men women 


produces the following results: 


1c1 
< Now is the time for all good men to 


> Now is the time for all good women to 
A three-way difference listing can be created with the diff3 command. 
For information about diff3 see diff3(C) in the XENIX Reference 
Manual. 


4.9.2 Echoing Arguments 


The echo command echos arguments to the standard output. For 
example, entering: 


echo hello 
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outputs: 
hello 


on the terminal screen. To output several lines of text, surround the 
echoed argument in double quotation marks and press RETURN 
between lines. A secondary prompt will appear until you enter the 
final double quotation mark. For example, enter: 


echo "Now is the time 
For all good men 

To come to the 

Aid of their party." 


This will output: 

Now is the time 

For all good men 

To come to the 

Aid of their party. 
Echo is particularly useful if you should ever program in the shell com- 
mand language. For more information about the shell, see Chapter 4, 
“The Shell’’, XENIX User’s Guide. 
4.9.3 Sorting a File 
One of the most useful file processing commands is sort. By default, 
sort sorts the lines of a file according to the ASCII collating sequence 
(i.e., it alphabetizes them). 
For example, to sort a file named phonelist, enter: 

sort phonelist 
In the above case, the sorted contents of the file are displayed on the 
screen. To create a sorted version of phonelist named phonesort, 
enter: 

sort phonelist >phonesort 
Note that sort is useful for sorting the output from other commands. 
For example, to sort the output from execution of a who command, 
enter: 

who | sort >whosort 
This command takes the output from who, sorts it, and then sends the 


sorted output to the file whosort. 
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A wide variety of options are available for sort. For more informa- 
tion, see sort(C) in the XENIX Reference Manual. 


4.9.4 Searching for a Pattern in a File 


The grep command selects and extracts lines from a file, printing only 
those lines that match a given pattern. For example, to print out all 
lines in a file containing the word “‘tty38”’, enter: 


grep tty38" file 


In general, you should always enclose the pattern you are searching for 
in single quotation marks (’), so that special metacharacters are not 
expanded unexpectedly by the shell. 


As another example, assume that you have a file named phonelist that 
contains a name followed by a phone number on each line. Assume 
also that there are several thousand lines in this list. You can use grep 
to find the phone number of someone named Joe, whose phone 
number prefix is 822, as follows: 


grep ‘joe’ phonelist | grep “822—° >joes.number 


Grep finds all occurrences of lines containing the word “joe” in the file 
phonelist. The output from this command is then filtered through 
another grep command, which searches for an *822-” prefix, thus 
removing any unwanted joes. Finally, assuming that a unique phone 
number for joe exists with the ““822-” prefix, that name and number 
are placed in the file joes.number. 


For more information about grep, its relatives fgrep and egrep, and 
the types of patterns it can be used to search for (called regular expres- 
sions) see grep(C) in the XENIX Reference Manual. 

4.9.5 Counting Words, Lines, and Characters 

We is a utility for counting words in a file. The letters ‘“‘we”’ stand for 
word count. Words are presumed to be separated by punctuation, 
spaces, tabs, or newlines. We also counts characters and lines; all 


three counts are reported by default. 


For example, to count the number of lines, words, and characters in 
the file textfile, enter: 


we textfile 


Typical output describing lines, words and characters might be: 
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4432 18188 97808 textfile 


To specify a count of characters, words, or lines only, you must use an 
appropriate mnemonic switch. 


To illustrate, examine the following three commands and the output pro- 
duced by each: 


wc —c textfile 
97808 textfile 


wc —w textfile 
18188 textfile 


wc —ltextfile 
4432 textfile 


The first example prints out the number of characters in textfile, the second 
prints out the number of words, and the third prints out the number of 
lines. 


4.0.1 Delaying a Process 


The at program allows you to set up commands to be executed at a 
specified time. It is useful if you want to execute a command when you are 
not planning to be at your terminal, or even logged in. 


The atcommand accepts standard input and has the form: 


cat file| at time day 


File is the name of the file that contains the command or commands to be 
executed. Time is the time of day, in digits, followed by “am” or “pm.” 
One- and two-digit numbers are interpreted as hours, three— and four-— 
digit numbers as hours and minutes. More than four digits is not permit-— 
ted. 


Day is optional. It is either a month name followed by a day number, or a 
day of the week. If no day is specified, the command will be executed 
today. 


For example, if you want to find out what processes are running at 10 pmon 
Tuesday, place the following line in a file named use: 


ps —a > /usr/myname/use 


(See Chapter 2, “Vi: A Text Editor,” of the XENIX User’s Guide for infor— 
mation on creating and inserting text into files.) 
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After you have written out the file and returned to command level, enter: 
cat use| at 10pm tues 


Press RETURN. The XENIX prompt reappears and you may continue 
working. At 10 pm on Tuesday, XENIX will execute ps—a and place the 
output in the file use. Atis unaffected by logging out. 


To check what files you have waiting to be processed, use the at —l com— 
mand. At —llists the files the user owns to be processed, along with the fol- 
lowing information: 


— The file’s ID number 

—~ Thecommand invoking the file (at or batch) 

— The date and time the file will be processed 
To cancel an at command, first check the list of files you have to be pro— 
cessed and note the file ID number. Then use the at —r command to 
remove the file or files from the list. 
The at —rcommand has the form: 

at -r number 

For example: 


at —r 504510300.a 


removes file number 504510300.a, canceling whatever commands were 
included in that file. A user can only remove his own files. 


4.1 Controlling Processes 


In XENIX, several processes can run at the same time. For example, you 
may run the sort program on a file in the “background”, and edit another 
file in the “foreground” while the sort program 1s running. Things that you 
directly control at your keyboard are called foreground processes. Other 
processes, which you can initiate but that you otherwise have little control 
over, are called background processes. At any one time you can have only 
one foreground process executing, but multiple background processes 
may execute simultaneously. Controlling foreground and background 
processes is the subject of this section. 
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4.10.1 Placing a Process in the Background 


Normally, commands sent from the keyboard are executed in strict 
sequence; one command must finish executing before the next can 
begin. Executing commands of this type are called foreground 
processes. A background process, in contrast, need not finish execut- 
ing before you give your next command. Background commands are 
especially useful for commands that may take a long time to complete. 


To place a process in the background, enter an ampersand (&) at the 
end of the command. For example, to count the number of words in 
several large files while simultaneously continuing with whatever else 
you have to do, enter: 


we filel file2 file3 >count& 


Output is collected in the file count. If output were not put in count, it 
would appear on the screen at unpredictable times as you continue 
with your work. 


When processes are placed in the background, you lose control of 
them as they execute. For instance, entering INTERRUPT does not 
abort a background process. You must use the kill command, 
described in the following section, instead. 


4.10.2 Killing a Process 


To stop execution of a foreground process, press your terminal’s 
INTERRUPT key. This kills whatever foreground command is 
currently running. To kill all your processes executing in the back- 
ground, enter: 


kill O 


To kill only a specified process executing in the background, first 
enter: 


ps 


Ps displays the Process Identification Numbers (PIDs) of your existing 
processes, for example: 


PID TTY TIME QvD 

3459 03 0:15 —sh 

4851 03 1:52 ce program.s 
5185 03 0:00 ps 
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In the above example, you might enter: 
kill 4831 


where 4831 is the PID of the process that you want killed. 


Note 


Killing a process associated with the vi editor may leave the ter- 
minal in a strange mode. Also, temporary files that are normally 
created when a command starts, and then deleted when the com- 
mand finishes, may be left behind after a kill command. Tem- 
porary files are normally kept in the directory /tmp. ‘This direc- 
tory should be checked periodically and old files deleted. 


4.11 Getting Status Information 


Because XENIX is a large, self-contained computing environment, 
there are many things that you may want to find out about the system 
itself, such as who is logged in, how much disk space there is, what 
processes are currently running. This section explains the types of 
information available from the system and how to get it. 


4.11.1 Finding Out Who is on the System 

The who command lists the names, terminal line numbers, and login 
times of all users currently logged on to the system. For example, 
enter: 


who 


This command produces something like the following output on your 
terminal screen: 


arnold tty02 Apr 7 10:02 
daphne tty21 Apr 7 07:47 
elliot tty23 Apr 7 14:21 
ellen tty25 Apr 7 08:36 
gus tty26 Apr 7. 09:55 
adrian tty28 Apr 7 14:21 
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The finger command provides more detailed information, such as 
office numbers and phone extensions. For more information, about 
using finger see finger(C) in the XENIX Reference Manual. 


4.11.2 Finding Out What Processes Are Running 


Because commands can be placed in the background for processing, it 
is not always obvious which processes you are responsible for. The ps 
command stands for “‘process status” and displays information about 
currently running processes associated with your terminal. For 
instance, the output from a ps command might look like this: 


PID TTY TIME QvD 

10308 38 1:36 ed chap02.man 
49 38 0:29 -sh 

11267 38 0:00 ps 


The PID column gives a unique process identification number that can 
be used to kill a particular process. The TTY column shows the termi- 
nal that the process is associated with. The TIME column shows the 
cumulative execution time for the process. Processes can be killed 
using the kill command. See section 4.10.2, “Killing a Process,” for 
information on how to use the kill command. 


To find out all the processes running on the system, use the a option: 
ps -a 
To find out about the processes running on a terminal other than the 
terminal you are using, specify the terminal number. For example, to 
find out what processes are associated with terminal 13, enter: 
ps -t13 
For more information about ps and its options, see ps(C) in the 
XENIX Reference Manual. 
4.11.3 Finding Out Lineprinter Information 
You can find out the status of files you requested printed with the 


Ipstat command. Ipstat displays information on an individual file or on 
all your files waiting to be printed. 
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To find out the status of one file, you need to know the “request ID.” 
When you make print requests using the Ip command, you find a 
request ID displayed on your terminal screen. The request ID has the 
form: 


printer—idnumber 
Printer is the name of the printer your file will be printed on (check 
with your system manager for the names of printers available to you) 
and idnumber is a unique number identifying your file. 
To find out the status of a particular file, enter: 


Ipstat request ID 


Ipstat responds by displaying the date and time you made your print 
request and the number of characters remaining to be printed. 


To find out the status of all your files waiting to be printed on the line- 
printers, enter: 


Ipstat 


Ipstat responds by displaying the request IDs and status information 
for all your files. 


You can find out what files are waiting to be printed on a particular 
printer by using Ipstat with the -p option. This command has the 
form: 


Ipstat -p printer 


Ipstat responds by printing the request IDs and status information for 
all the files waiting to be printed on the named printer. 


For more information on Ipstat and its options, see Ipstat(C) in the 
XENIX Reference Manual. 


4.12 Using the Lineprinter 


The XENIX lineprinter commands are easy to use and give you great 
flexibility when you want to print a file. With a few simple commands, 
you can print multiple copies of a file, cancel a print request, or ask 
for a special option on a particular printer. Since the XENIX line- 
printer system is designed to be easily adapted to many different 
environments, check with your system manager to find out what line- 
printers and printer options are available to you. 
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4.12.1 Printing Files: Ip 

To print copies of your files, you can use either the Ip command or 
Ipr. These commands are equivalent. The examples in this section 
use Ip. 

For example, to print one copy of a file named memo, enter: 


Ip memo 


You can request that several files be printed. For example, to print 
three files named memo,report, and letter, enter: 


Ip memo report letter 
When you make print requests, Ip responds by displaying your 
“request ID” on your terminal screen. Your request ID might look like 
this: 

pr4-532 
The first part (pr4) is the name of the printer your file will be printed 
on. The second part (532) identifies your file. Should you later wish 
to cancel your print request or check its status, you will find it useful 
to remember your request ID. For more information on these tasks, 
see sections 4.12.3, “Canceling a Print Request,” and 4.12.4, “Finding 
Out the Status of A Print Request.” 


One copy of each file you named will be printed on the default destina- 
tion printer on your system. 


You can use Ip with pipes and other commands. The command to 
paginate a file is pr. To paginate and print a file named textfile, enter: 


pr textfile | Ip 
To sort, paginate, and print a file named datafile, enter: 


sort datafile | pr | Ip 


4.12.2 Using Lp Options 


The Ip command has several options to help you control the output 
from your printer. 
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You can specify the number of copies you want printed by using the 
number option, -n. For example, to print two copies of a file named 
report, enter: 


Ip report -n2 
Another option, -d, specifies your file’s destination, that is, which 
printer your file will be printed on. Check with your system manager 
for the names of the printers available to you. To have two copies of 
a file named report printed on a printer named quick, enter: 

Ip report -n2 -dquick 
Other useful options include: 

-c Makes a copy of the files you are printing. This prevents you 
from inadvertently removing or changing the file before it is 
printed. 

-m_ Sends you mail telling you your file has been printed. 

-o Specifies printer options. For example, you may be able to 
request that your document be printed using 12 pitch type. 
Check with your system manager to see what options are 
available for each printer or groups of printers on your sys- 
tem. 


-r Removes your files after printing. 


For more information on options available for the Ip command, see 
Ip(C) in the XENIX Reference Manual. 


4.12.3 Canceling a Print Request: Cancel 


You can cancel a print request. For example, to stop printing a file 
with a request ID of laser-245, enter: 


cancel laser-245 


The cancel command immediately stops the file from being printed, 
even if the printer has already begun the print request. 


You can also use the cancel command to stop whatever is currently 
printing on a particular printer. With cancel, you can easily free up a 
printer to print the next file, or stop it from printing strange output 
without contacting your system manager. 
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For example, to cancel whatever file is currently printing on a printer 
named slow, enter: 


cancel slow 
If the file did not belong to you, mail will automatically be sent to the 
file’s owner reporting that the print request was canceled. 
4.12.4 Finding Out the Status of A Print Request: Lpstat 
To find out the status of your files waiting to be printed, enter: 
Ipstat 


Ipstat responds by displaying something like this on your terminal 
screen: 


prt1-121  chrisw 450 Dec 15 09:30 
laser-450 chrisw 4968 Dec 15 09:46 


The first column shows the request ID for each of your files being printed; 
the second column is your login name. In the third column, the number of 
characters to be printed is shown, and the fourth column lists the dates and 
times you made your print requests. 


To learn the status of a particular file, use the Ipstat command with your 
request ID. For example, to find out the status of a file with the request ID © 
of daisy-256, enter: 

Ipstat daisy-256 
Ipstat displays the status of that file only. 
You can also request the status of various printers on your system by using 


the -p option or by giving the name of the particular printer you are 
interested in. 
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To find out the status of all the printers on your system, enter: 


Ipstat -p 


To find out the status of a printer named quick, enter: 
Ipstat -pquick 


lpstat displays the request ID and status information for each file currently 
waiting to be printed on the printer named quick. 


For more information on Ipstat and its options, see /pstat(C) in the XENIX 
Reference Manual. 


4.13 Communicating with Other Users 


Because the XENIX system supports multiple users, it is very convenient to 
communicate with other users of the system. The various methods of com- 
munication are described below. 


4.13.1 Sending Mail 


Mail is a system-wide facility that permits you and other system users to 
send and receive mail. To send mail to another user on the system, enter: 


mail joe 


where joe is the name of any user of the system. Following entry of the 
command, you enter the actual text of the message you want to send. Entry 
of text is terminated by pressing Ctrl-D. 


A complete session at the terminal might look like this on your screen: 


mail—s "Meeting today" joe 

There will be a meeting at 2:00 today 
to review recent problems with the 
new system. 

Ctrl-D 


Note the use of the —s switch to specify the subject of the message. 


For practice, send mail to yourself. (This is not as strange as it might sound 
— mail to yourself is a handy reminder mechanism.) You can also send a 
previously prepared letter, and you can send mail to anumber of people all 
at once. For more details, see Chapter 6, “Mail”, and mail(C) in the 
XENIX Reference Manual. 
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4.13.2 Receiving Mail 

When you login, you may sometimes get the message: 
you have mail 

To read your mail, enter: 
mail 


A heading for each message is then displayed on your terminal screen. 
When you press RETURN, the contents of the first message are displayed. 
Subsequent messages are displayed, one message at a time, most recent 
message first, each time you press RETURN. 


After each message is displayed, mail waits for you to tell it what to do with 
the message. The two basic responses are d, which deletes the message, 
and RETURN, which does not delete the message (so it will still be there 
the next time you read your mailbox). To exit mail, enter: q, for “‘quit.” 
Other responses are described in the XENIX Reference Manual under 
mail(C). 


4.13.3 Writing to a Terminal 


To write directly to another user’s terminal, use the write command. For 
example, to write to joe’s terminal, enter: 


write joe 


After you have executed the command by pressing RETURN, each subse- 
quent line that you enter is displayed both on your own terminal screen and 
on joe’s. To terminate the writing of text to joe, enter a Ctrl-D alone ona 
line. 


The procedure for a two-way write is for each party to end each message 


with a distinctive signal, normally (0) for “over”; when a conversation is 
about to be terminated use the signal (00) for “over and out.” 


4.14 Using the System Clock and Calendar 
There are several XENIX commands that will tell you the date and time, or 


display a calendar for any month or year you choose. The following sec- 
tions explain these commands. 
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4.14.1 Finding Out the Date and Time 
The date command displays the time and date. Enter: 
date 


The date and time are displayed in the bottom left corner of the screen. 


4.14.2 Displaying a Calendar 


The cal command displays the calendar of any month or year you specify. 
This command has the form: 


cal month year 
For example, to display the calendar for March, 1952 enter: 


cal 3 1952 


The result is: 


March 1952 

S MTu WTh F S 
1 

2 es, eS Be OY od 

9 10 11.12 13 14 15 

id; ts 38 39 20 27 22 

25 24525 26 27 28-29 

30 *3% 


The month must always be expressed as a digit. To display the calen- 
dar for an entire year, leave out the month. The year must always be 
expressed in full; the command “cal 85” displays the calendar for the 
year 85, not 1985. 
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4.15 Using the Automatic Reminder Service 


An automatic reminder service is normally available for all XENIX 
users. Once each day, XENIX uses the calendar command to examine 
each user’s home directory for a file named calendar, the contents of 
which might look something like this: 


1/23 David’s wedding 
2/9 Mira’s birthday 
3/30 Paul’s birthday 
4/27 Meeting at 2:00 
9/1 Karen’s birthday 
10/3 License renewal 


Calendar examines each line of the calendar file, extracting from the 


file those lines containing today’s and tomorrow’s dates. These lines 
are then mailed to you.to remind you of the specified events. 


4.16 Using Another User’s Account 
You can easily access another user’s files, regardless of the permission 
settings, with the su command. The su procedure resembles logging in, 
and you must know the other user’s password. 
For example, to become user Joe, enter: 

su joe 
and press RETURN. When the password prompt appears, enter Joe’s 


password. To cancel the effect of the su command and return to your 
own account, press Ctrl-D. 


4.17 Calculating 


The be command invokes an interactive desk calculator that can be 
used as if it were a hand-held calculator. A typical session with be is 
shown below. Comments explain what action is performed after each 
input line: 
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/* This is a comment */ 

123.456789 + 987.654321 /* Add and output */ 
1111.111110 

9.0000000 — 9.0000001 /* Subtract and output */ 
—.0000001 

64/8 /* Divide and output ug 


8 

1.12345678934 * 2.3 /* Note precision */ 
2.58395061548 

19%4 /* Find remainder */ 

3 


3°4 /* Exponentiation */ 
81 
Zii*2 /* Note precedence */ 


4 
2/(1*2) /* Note precedence again */ 
1 


x= 46.5 /* Assign value to x ny 
y=52.5  /* Assign value to y =f | 
x + y + 1.0000 /* Add and output */ 
100.0000 


obase=16 /* Set hex output base */ 
15 /* Convert to hex aif 


F 

16 /* Convert to hex + / 
10 

64 /* Convert to hex + / 
AO 

255 /* Convert to hex be! 
FF 

256 /* Convert to hex */ 
100 

512 /* Convert to hex */ 
200 


quit /* Must type whole word */ 


Also available are scaling, function definition, and programming state- 
ments much like those in the C programming language. Other features 
include assignment to named registers and subroutine calling. For 
more information, see Chapter 5, “BC: A Calculator”, XENIX User’s 
Guide. 


4-38 


Index 


Characters 


(o), write command message end 4-35 
(00), write command message end 4-35 
* See Asterisk (*) 
- See Dash (-) 
-a option 
function 3-10 
-] option 
function 3-10 
-r option 3-10 
-R option, recursive listing 4-13 
-s option 3 
mail, subject specification 4-34 
-V option 
function 3-10 
. See Period (.) 
/ See Slash (/) 
? See Question mark (?) 
[] See Brackets 
> See Greater-than sign 


A 


a character, permission change 4-20 
Absolute pathname See Pathname 
Account, new user 2-1 
Addition See Calculation 
Alphabetizing See sort command 
Ampersand (&) 
background command 3-9 
background process 4-27 
Appending files 4-8 
Appending See Output 
Argument 
switch See Switch 
Asterisk (*) 
filename wildcard 3-8 
filename, use avoidance 3-5 
pattern matching functions 3-7 
at command 4-25 
atrm command 4-26 


B 


Background process 4-27, 4-27 

ampersand (&) operator 4-27 
Backslash (\) 

erasing 24 

escape character 2-4 
BACKSPACE key 


BACKSPACE key (continued) 
erasure function 2-4 
literal 2-4 
Batch processing See Command 
be command 
calculation 4-37 
/bin directory 
contents 3-5 
Binary file See File 
BKSP key 
command-line buffer editing 3-9 
Block special device 4-18 
Brackets ({]) 
filename, use avoidance 3-5 
pattern-matching functions 3-8 
BREAK key 
program stopping 2-5 
terminal nonsense character removal 2-1 
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cal command 4-36 
Calculation 
example 4-37 
calendar command 4-37 
cancel 
Case significance 2-2 
cat 
command 4-7 
file 
combining 4-8 
contents display 2-3 
cd command 4-16 
directory change 3-5 
Changing password 4-2 
Changing terminal types 4-3 
Character counting 4-24 
Character special device 4-18 
chmod command 4-19, 4-21 
directory permission change 3-2 
file permission change 3-1 
Command line 
ampersand (&) effect 3-9 
buffer defined 3-9 
defined 3-9 
entry 44 
erasure 4-5 
interpretation 3-9 
multiple commands entry 3-9 
RETURN key effect 44 
See also Specific Command 
background submittal 3-9 
batch processing 
See background submittal 
dash (-) use 3-5 
directory See /bin directory 
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Command line (continued) 
directory See Directory 
entering error correction 2-4 
execution 3-9 

RETURN key required 2-2 
sequence 4-27 
lowercase letters 3-10 
multiple commands entry 3-9 
name error 2-2 
program invocation 3-9 
RETURN key required 2-2 
syntax 3-10 
typing error correction 2-4 

Commands 

at 4-25 


diff3 4-22 

echo 4-22 

find 4-10 

head 4-7 

kill 4-29 

Ic 4-12 

In 4-11 

mkdir 4-14 

more 4-5 

mv 4-9 

passwd 4-2 

ps 4-27 

pwd 4-16 

rm 4-10 

rmdir 4-14 

sort 4-23 

stty 44 

tail 4-7 

we 4-24 
Comparing files 4-22 
Concatenate See cat command 
Control characters 

filename use restrictions 3-5 
Copy command 4-15 
Copying a directory 4-15 
Copying files 4-9 
Copying See cp command 
Counting, wc command 4-24 
cp command 4-9 
Creating a directory 4-14 
Creating a file 4-5 
Ctrl-C, program stopping 2-5 
Ctrl-D 

end-of-file 4-2 

logging out 2-5 

mail 4-34 
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Ctrl-Q, output resumption 4-5 
Ctrl-S, output stopping 4-5 
Ctrl-U 

command-line buffer editing 3-9 

kill character 24 

line kill 4-5 

literal 2-4 
Current directory 

change 3-5 

procedure 4-16 

description 4-16 

printing 4-12 

shorthand name 3-6 

user residence 3-6 
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d command 
mail, message deletion See Mail 
Dash (-), permission 
denial notation 4-18 
ordinary file notation 4-17 
command option use 3-5 
filename, use avoidance 3-5 
switch use 3-10 
date command 2-2, 4-36 
DELETE key 
program stopping 2-5 
Deleting a file 4-10 
Deletion See d command 
Demonstration 2-1 
/dev directory 
contents 3-5 
/dev/console directory 
contents 3-6 
/dev/tty directory 
contents 3-6 
Device special file See Special file 
filename 34 
filenamerequired 34 
pathname 3-4 
Diff command 4-22 
diff3 4-22 
Directory 
/bin See /bin directory 
/dev See /dev directory 
/lib See /lib directory 
/tmp directory 4-28 
/tmp See /tmp directory 
/tty See /tty directory 
/usr See /usr directory 
access permission See Permission 
changing 4-16 
command See cd command 
composition 3-2 
copying 4-15 
creating 4-14 


Introduction to XENIX 


Directory (continued) 


current directory See Current directory 


description 3-2 
diagram 3-3 
file See File 
filename 
required 3-4, 34 
unique to directory 3-4, 3-4 
listing 4-13 
columns 4-12 
logging in result 3-3 
long listing 4-13 
nesting 3-2 
parent directory See Parent directory 
pathname required 3-4 
permission notation 4-18 
permission See Permission 
protection 3-2 
recursive listing 4-13 
removing 4-14 
renaming 4-15 
search permission See Permission 
user control 3-2 
working directory 
See Current directory 
Displaying a file 4-5 
Division See Calculation 
Double quotation marks 


See Quotation marks, double (’’) 


EK 


echo command 4-22 
description, use 2-3 

egrep See grep command 

Entering error correction 2-4 

/etc/termcap file 4-4 

Exponentiation See BC 

Exponentiation See Calculation 


F 


fgrep See grep command 
File permissions 
changing 4-19 
listing 4-14 
File system 
defined 3-3 
diagram 3-4 
organization 3-3 
access 
control 3-1 
last access time 3-1 
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File system (continued) 
access (continued) 
permission See Permission 
addition See creation 
alphabetizing See sort 
appending 4-8 
attributes 3-1 
binary file 3-1 
combining 4-8 
composition 3-1 
copying 4-9 
creating 4-5 
creation 
permission See Permission 
time 3-1 
write permission control 3-2 
defined 3-1 
deleting 4-10 
deletion 
write permission control 3-2 
directory See Directory 
displaying 4-5, 4-7, 4-7 
editing See Vi 
filename See Filename 
inode number See Inode number 
linking 4-11 
listing 3-2 
manipulation 4-5 
modification time 3-1 
moving 4-8, 4-8 
name See Filename 
pathname required 3-4 
pathname, printing 4-16 
pattern search 
See Pattern matching facility 
permission See Permission 
permissions 4-17 
protection 3-1 
removal 4-10 
renaming 4-9 
scratch file directory 3-6 
size in bytes 3-1 
sorting 4-23 
special file See Special file 
temporary file See Temporary file 
types designated 3-1 
Filename 
asterisk (*) wildcard 3-8 
characters use restrictions 3-5 
description 34 
example designated 3-6 
long listing 4-14 
question mark (?) representation 3-8 
required 3-1, 3-4, 34 
unique to directory 3-4, 34 
Files 
comparing 4-22 
find command 4-10 
Finding a file 4-10 
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finger command 4-29 
Foreground process 4-27, 4-27 
Full pathname See Pathname 


G 


Greater-than sign (>) 
file combination 4-8 
output redirection 3-12 
redirection symbol 2-3 

grep command 4-24 

Group permission See Permission 


H 


head command 4-7 
Home directory 4-16 


I 


Inode number 
defined 3-2 
link See Link 
ls command 3-2 
required for file 3-1, 3-2 

Input 
keyboard origin 3-11 
redirection See Redirection 
termination 4-2 

INTERRUPT key 
command-line buffer cancellation 3-9 
foreground process killing 4-27 
logging in, nonsense 

character removal 2-1 

program stopping 2-5 

Kill character See Ctrl-U 

kill command 4-27, 4-29 

Killing a process 4-27 


L 


1 command 4-13 

lc command 4-12 
listing 2-3 

Less-than symbol (<) 
input redirection 3-12 

/lib directory 
contents 3-6 

Line 
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Line (continued) 
counting See wc command 
Lineprinter 
status information 4-29 
Link 
command See In command 
defined 3-2 
description 4-11 
long listing 4-14 
Linking files 4-11 
Listing directory contents 4-12 
Listing See 1 command 
Listing See lc command 
In command 4-11, 4-11 
Logging in 4-1 
nonsense character removal 2-1 
procedure 2-1 
prompt character 2-1 
terminal behavior remedy 2-5 
type-ahead restriction 24 
Logging out 
procedure 2-5, 4-2 
terminal behavior remedy 2-5 
Login directory 
new user 2-1 
Login message 2-2 
Login name 
new user 2-1 
procedure 4-1 
Ip 4-31, 4-32, 4-33 
Ip 


r 
Ipstat 4-29, 4-33 
ls command 


function 3-2 
inode number use 3-2 
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Mail 
-s option 4-34 
command 
mail command See mail command 
d command 4-35 
exit 
q command 4-35 
message 
deletion 4-35 
display 4-35 
prompt 4-35 
q command 
exit 4-35 
reading 4-35 
reminder service 4-37 
sending 4-34 
you have mail message 2-2 
Make directory See mkdir command 
mkdir command 4-14 
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more command 4-5 

Move See mv command 

mv command 4-8, 4-9 
directory moving 4-15 


N 


Name special file 4-18 
Named pipe 4-18 


O 


Options 
configuration 3-10 
grouping 3-10 
multiple options 
grouping See grouping 
separate listing 3-10 
position 3-10 
terminal 4-4 
Ordinary file See File 
Output 
appending 
procedure 3-12 
symbol (>) 3-12 
control 4-5 
file reception 2-3 
redirection 2-3, 4-8 
resumption 4-5 
terminal screen destination 3-11 
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Parent directory 
description 36 
shorthand name 3-6 
passwd command 4-2 
Password 
changing 4-2 
invisible on screen 2-1 
logging in 2-1 
new user 2-1 
Pathname 
absolute pathname 
example 3-6 
required 3-4 
slash (/) significance 3-5, 3-5 
unique to system 34 
defined 3-5 
full pathname See absolute pathname 
relative pathname 
defined 3-5 
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Pathname (continued) 
relative pathname (continued) 
example designated 3-6 
structure 3-5 
Pattern matching facility 
cancellation 3-8 
characters 3-7 
description 3-6 
grep command 4-24 
Period (.) 
filename use 3-5 
working directory change 4-17 
Permission types 4-18 
block special device notation 4-18 
change 3-2 
denial notation 4-18 
directory permission 
assignment 3-2 
change 3-2, 4-19 
combinations designated 4-19 
file creation, deletion notation 4-18 
file listing notation 4-18 
notation 4-18 
search notation 4-19 
search permission 4-21 
write permission 3-2 
execute notation 4-18 
file permission 
change 3-1 
denial notation 4-18 
execute permission 4-18 
file creation, deletion notation 4-18 
file listing notation 4-18 
file protection 3-1 
notation 4-17 
read notation 4-18 
required 3-1 
write notation 4-18 
listing 4-17 
notation 4-17 
read notation 4-18 
search notation 4-19 
symbols designated 4-17 
user class specification 4-20 
write notation 4-18 
PID 
process identification number 4-27, 4-29 


Pipe 
function 3-13 
procedure 3-13 
symbol (|) 3-13 
Pipeline 
defined 3-13 
Print working directory See pwd command 
Printing 
Process identification number See PID 
background See Background process 
foreground See Foreground process 
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Process identification number See 


PID (continued) 
status 
status 4-29 
Program stopping 2-5 
Prompt character 2-1, 4-1 
ps command 4-27, 4-29 
pwd command 4-12, 4-16 
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q command 
mail 
exit 4-35 
Question mark (7?) 
filename, use avoidance 3-5 
pattern-matching functions 3-8 
single character representation 3-8 
Quit See q command 
Quotation marks, double (’’) 3-5 
Quotation marks, single (’) 
filename, use avoidance 3-5 
grep command 4-24 
pattern matching cancellation 3-8 
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r character, read permission notation 4-18 


Read-ahead 2-4 
Redirection 
input redirection 
procedure 3-12 
symbol (<) 3-12 
output redirection 4-8 
symbol (>) 2-3 
Reference Manual 
directory removal information 4-15 
linking information 4-11 
sort command information 4-24 
stty information 4-4 
terminal characteristics setting 2-5 
Relative pathname See Pathname 
Reminder service 
automatic 4-37 
Remove directory See rmdir command 
Remove See rm command 
Removing a directory 4-14 
Renaming a file 4-9 
Request 4-31 
RETURN key 
command execution 2-2, 4-4 
command-line buffer submittal 3-9 
mail, message display 4-35 
rm command 2-3, 4-10 
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rmdir command 4-14 
RUBOUT key, program stopping 2-5 


S 


Screen See Scrolling screen 
Screen See Terminal screen 
Scrolling commands 

more 4-6 
Scrolling screen 

stopping 4-5 
Scrolling, control 4-5 
Search permission See Permission 
Search strings 

example designated 3-10 
Searching for a file 4-10 
Semaphore 4-18 
Semicolon (;) 

command separation 3-9 
Shell 

command interpretation 3-9 

echo command 4-23 

TERM variable See TERM variable 


Single quotation marks See Quotation marks, 


single (’) 
Slash (/) 
absolute pathname significance 3-5 
pathname significance 3-5 
sort command 4-23 
Special characters 
designated 3-7 
pattern matching 3-6 
Special file 
description 3-2 
Shared data file 4-18 
Status 
command See ps command 
information procedures 4-28 
stty command 44 
terminal setting 2-5 
Subdirectory 4-17 
Subtraction See Calculation 
Switch 
defined 3-10 
regulations See Option 
System 
basic concepts 3-1 
characteristics 1-2 
composition 1-1 
tree-structured directory system 3-2 
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tail command 4-7 
Temporary file 
directory (/tmp) 4-28 
kill command warning 4-28 
TERM variable, changing 4-3, 4-4 
Terminal screen 
output See Output 
scrolling screen See Scrolling screen 
changing 4-3 
name designation 2-2 
options setting 44 
resetting 2-5 
strange behavior remedy 2-5 
writing to See write command 
Terminals 
supported 4-4 
/tmp directory 4-28 
contents 3-6 
tty, terminal system name 2-2 
Type-ahead 24, 4-5 
‘Typing error correction 2-4 
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ugo, permission Classification 4-20 
umask command 

directory permission change 3-2 
User classes 4-20 

addition 2-1 

classification 4-20 

mail See Mail 

new user 2-1 

permission See Permission 
/usr directory 

contents 3-5 
/usr/bin directory 

contents 3-5 
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Vertical bar (|) 
pipe symbol 3-13 
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w character 
directory permission notation 4-18 
file permission, write notation 4-18 
we command 4-24 
word count 3-13 
who command 4-28 
logged in users list 3-13 
Word 
counting See wc command 
Working directory See Current directory 
write command 4-35 
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directory permission search 4-19 
file permission, execute notation 4-18 


